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Let’s start! 


Recombee is an Al-powered recommendation engine that serves real-time 
recommendations for Media, E-commerce, Marketplaces, and many other verticals. This 
handbook was created for a wider audience and will serve you as a guide to help you to 
integrate our solution in the easiest way possible with minimal coding involved. 


This setup showcases the fastest, easiest integration through Admin UI without the need for 
API or coding. For API integration see our documentation or see a short comparison at the 


end of this guide. 


Before we start, please make sure you have your Recombee account created. 
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Integration in 3 steps 


The integration consists of 3 main steps - synchronize your catalog using a catalog feed, 
set up your first scenario, and create a recommendation box visualization through HTML 
Widget. Below you can see how Recombee works with synchronized items from your 
catalog feed and sent interactions from created HTML widget to show recommendations. 


æ Synchronize items 
YOUR DATA i Q =. Show Recommendations 


R Send Interactions 


A Recombee 3 


1 Synchronize your catalog using a catalog 
feed 


Send us your catalog information through one of the following types of feeds using 
Recombee Admin UI. 


1 Create Catalog Feed 
Visit the section Catalog Feed in your Admin UI. See Integrations on the left-hand side. 


£5 Catalog Feed 


Setup Your Feed 


Using a catalog feed is an alternative to using API + SDK for uploading your item 
catalog. The feed is periodically crawled and item catalog updated 


+ Create Feed 


2 Choose your Feed Type 


=: Catalog Feed Create Feed Cancel 


Choose a Feed Type 


Google Merchant Feed 


H T 


Heureka Feed 


A 


Atom/RSS 


Custom XML 


E, 


Custom CSV 


g 
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E-commerce content (product catalog): 


e Google Merchant 
e Heureka XML 


Text-based content: 
e Atom/RSS - Are used by news websites and many blog pages or podcasts in order 
to provide structured information about the offered content. 


Other: 
e Custom XML - An XML that contains structured information about the items. 
e Custom CSV - A CSV file where each line contains data for a single item. 


3 Setup catalog feed URL 
Insert your catalog feed URL (Atom/RSS is used as an example below). 


sa Catalog Feed Create Feed 


Atom/RSS 
Atom / RSS feeds are used by the news websites and also many blog pages or podcasts to provide structured information about the offered Change 
content. Read more 


Feed URL 


XML file can be also compressed into .zip or .gz 


https://example.com/feed.xml Apply and Setup 


Settings 


Mapping Rules 


Note: It may take up to 5 minutes to process items from your feed. 
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4 Choose properties used in recommendations 
Optional for certain types of feeds, e.g. RSS, XML, CSV. 


Mapping Rules 


Here you can see the properties that will be parsed from the feed. You can set a custom XPath (relative to the root element of an item) for each of them. The default path 
is the name of the property. 


Property Data Type Path © 
@ title New String ba + itle +++ Choose it 
@ link New String ~ 4- link *** Choose î 
Create new property 


Name Enter a property name Data Type Select option... ~ + Create property 


Availability Property (optional) 
Value to which the feed processor should set the property that defines the item's availability when the item gets removed from the feed. 


Choose a property... v 


SUGGESTED 
@ pubDate Timestamp X + pubDate 
@ description String hd + description 
@ author String X + author 
@ categories Set + + category 
@ media:content Image list ~ + media:content/@url 
¥ Show all 6 suggestions 


Add properties that are applicable to your use case in the mapping rules section. Select the 
properties by clicking on the plus button. Examples of properties can be: title, genre, 
images, categories, etc. 


Tip: The catalog feed is updated by default every 4 hours. This period can be shortened to 
your needs by contacting support@recombee.com. 
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5 Check synchronization 
In the menu Catalog feed, check if items from your catalog have been successfully added 
to your database. 


Update Logs 
Result Message Updated Disabled Errors 
OK 
Qo Successfully updated 6784 35 0 


Nov 21, 2019 19:09 


Skipped 


Feed hasn't changed since last update 
Nov 21, 2019 15:08 


OK 
Successfully updated 6692 3 0 
o Nov 21, 2019 11:08 dizi 


OK 
Successfully updated 
o Nov 21, 2019 07:06 Y Up! 6685 5 0 


OK 
Sı full: dated 
O iov 21, 2019 03:05 uccesstully up 6686 32 0 


OK 
Successfully updated 6697 26 0 
o Nov 20, 2019 23:03 ae 


OK 
Successfully updated 6707 39 0 
o Nov 20, 2019 19:02 yP 


Skipped 


Feed hasn't changed since last update 
Nov 20, 2019 15:00 


oK 
Successfully updated 709 
o Nov 20, 2019 11:00 = uly up’ 670 3 0 


OK 
Successfully updated 6692 4 0 
o Nov 20, 2019 06:59 ipi 
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2 Set up your first Scenario 


After you finish synchronizing the catalog, create & set up your first scenario. Each scenario 
defines a particular application of the recommendations at your website, mobile app, or 
email. 


For demonstration purposes, we use an example of the “Similar Product” scenario for 
e-commerce, aimed to show personalized offers of similar products to the currently viewed 
one. 


Important: The integration steps below are applicable across all industries. For specific 
scenarios setup see our Scenario Setup Guide for Content Recommendation or Scenario 
Setup Guide for Product Recommendations. 





1 Create scenario 
Visit section Scenarios in your Admin UI on the left menu and click on Create Scenario. 


® Database * Scenarios Q Search Scenarios. 


INSIGHTS 


al Ke! Č Scenario defines a particular application of the recommendations. It can be for example homepage, watch-next or emailing-after-purchase. You can apply various 
b settings to each Scenario. Read more 





CATALOG 


i= Items 


Global Settings © A 


ia Users 


> Series SCENARIOS 


RECOMMENDATIONS 


® Business Rules 


2 Setup new scenario 
Name your recommendation scenario e.g. Similar Products and select the recommendation 
type, e.g. Items to Item. 


* Scenarios Create Scenario 


Create Scenario 


iZi Not sure which type of recommendation to pick? See the Integration Tips section for more 
information about typical scenarios and their settings. 


Name 

Enter a scenario name. 
Scenario ID Start typing to generate a Scenario ID... 
Recommendation type 


Items to Item 
— Recommends set of items that are related to one given item. 
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3 Set logic to define the behavior of the scenario 
You can choose from Universal, E-commerce, or Marketplaces (Classified Advertisin 


Models. We have selected ecommerce:similar-products Logic from the E-commerce 
Models. 


* Scenarios Similar-Products Items to Ite > Preview Results 


Logic Filters (0) Boosters (0) Other Integration 


WI The logic allows you to specify the desired behavior of the recommendation model 


General 


Type 





Universal Models default + 





Universal Models E-commerce Classified Advertising of collaborative filtering and content-based recommendation, backed by 


ee 3ing continuously optimized by Al so it automatically adapts to incoming 
Models specifically tuned for E-Commerce use-cases. 


ecommerce:similar-products @ 
ecommerce:cross-sell @ 


ecommerce:bestseller @ 


4 Tailor scenarios towards your business goals with custom or predefined Boosters or 


Filters 


Show products X times more likely than the non-boosted products by using booster, or use 


filter to eliminate the visibility of specific items. In this case, we have added an Upsell 
booster. 


Add Boosters Q Search Booster. 
* Scenarios © Similar-Products  jtems ‘0 i > 


All (3) My (0) Recombee (3) 


Logic Filters (0) Boosters (0) Other Integration Boost nearby items ® 


Boost nearby items. Applicable to item-based recommendations 


Č Boosters allow you to prefer some Items in this Scenario in order to fulfill your business goals. You can pick some p i á 
your own Business Rules. oost recent items 
Prefer recent items 





Override booster API parameter © Upsell ® 


Boost items with higher price (or margin) than currently viewed item. Applicable to item-based 
recommendations. 
Global Settings No Boosters 


No Boosters added 


Start by adding your first Booster. 


+ Add first Booster 


@ Recombee 


Global Settings No Boosters Edit 


® Upsell © : 


Boost items with higher price (or margin) than currently viewed item. Applicable to item-based recommendations. 


Price property 
Property that specifies the price or margin of the item 


price hg 


Boosting coefficient 
Specifies how much the recent items should be boosted. Higher coefficient results in a greater boost of the item, 1 means no boost. 


1 0.1 @ 10 


+ Add Booster 


5 Don’t forget to update the settings when you are finished 
Changes are applied immediately. 


* Scenarios > Similar-Products items to item > Preview Results 


e 
Logic Filters (0) Boosters (1) Other Integration 





(2) The logic allows you to specify the desired behavior of the recommendation model 


General 
Type 


Universal Models default ~ 


Default model ensemble aiming to work well in most common use-cases. It is an ensemble of collaborative filtering and content-based recommendation, backed by 
popularity-based models when there's not enough data in given context. The ensemble is being continuously optimized by Al so it automatically adapts to incoming 
data. 


Override logic API parameter © 
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Tip: You can see how recommendations work by clicking on Preview Results. Choose an 
item or user and Recombee will show you recommended items or users. 


© Dstebace * Scenarios © detail-alternatives tems to er 
insiGHTs 
al KPI Logic Filters (1) Boosters (2) Integration 
CATALOG 
(2) The logic allows you to specify the desired behavior of the recommendation model. 
I= Items 


b Preview Results 


Item ID 5591979720859 Choose item Target user ID 





ITEM PROPERTIES 


id image deleted handle 
5591979720859 4) x 


spisebord-metaltrae-sort 


Recommendations 


id image deleted handle 


5590948937883 spisebord-slated-sort 


5592020549787 rq x 


skrivebord-metal-trae-sort 
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Enter target user ID. 


link 


/products/spisebord-metaltrae-sort 


link 


/products/spisebord-slated-sort 


/products/skrivebord-metal-trae-sort 


Choose target user 











note 


Product available at moodings.com 


note 


Product available at moodings.com 


Product available at moodings.com 


price 


2897 


price 


4199 


2187 


‘Show 


product.title 


Spisebord - metal/trae, sort 


product title 


Spisebord, Slated, Sort 


Skrivebord -metal/tree, sort 


© item properties 


Interactions 


Ei 


type vendor 


Spisebord Hübsch 


Show 5 ~ items © 


type vendor 
Spisebord House Doctor 
Skrivebord Hübsch 
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3 Create a recommendation box visualization 
through HTML Widget 


Using an HTML Widget is the easiest way to display the recommendations on your website. 
This type of integration automatically gathers live interactions of your users - the detail 
views. 


1 Click on the Widgets section on the left menu and choose “Create widget” 


® Database © Widgets + Create Widget 


ČI Widget 





al KPI 





Start b! g a new Widget 





$5 Catalog Feed 


<> Widgets 


2 Fill in the widget title and link it with the scenario that you have just created 


<> Create Widget 


Title 





Enter a widget title. 





Scenario 


Select a Scenario. 


Cancel Create Widget 
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3 Set which item properties will be shown, adjust the visual settings, or even set what 
needs to be displayed to match your current design 


< detail-accessories 4 y detail-accessories <> Embed Code v Update 
Aa Default =) Grid B Width Range |... Layout ~ @ VV temconett ag Preview for Fy 
default ten default size P 900.1200 IH sxctitems.1*10 spacing * @ — 7 Mem Content © ‘em ID 5591979720859 
Z item Content x 
o 600 
p menu @ 
= i 
® link ~ 
mace o 
Image w 
Mugs muues EBERHART FURNITURE TRADITION TRADI PROPERTIES o 
Tillaegsplade Space Natura.. Tilleegsplade Space Smoke.. Hector Extra Leaves Tillæg.. In Between Chair - SK2 - S.. In Betv = 
vendor STRING A 4 
1,769.0 kr 1,769.0 kr 8,995.0 kr 4,495.0 kr 2,79! 
product title STRING vu Aa ct 
price DOUBLE vat Aa ct 
+ Add 


4 Provide item ID 

Recommendation algorithms need to know which item was selected by the user, so it can 

find similar products to recommend. You can find the place for Item ID in the Embed code, 
shown as the green rectangle ITEM_ID. This ID is unique for each item that your customers 
see, thus it needs to be set dynamically. We are using the Shopify website template in this 

example. Shopify identifies each product by handle {{product.id}}. 


1. Paste the embed code into your text editor. 

2. Find the line with “itemld”. 

3. In this line, replace ITEM_ID so that it will be dynamically set for each value. If you 
use Shopify you simply put “{{product.id}}”. 


Note: You might need to consult this step with your webmaster if needed. Don’t forget 








quotes “” 
< detail-accessories 4 ye detail-accessories Embed Code x 
Aa Default a= nem FA) Sid Box p Width Range _ 
default size default size 900-1200 
o Default Custom User ID S&S Segment ©} Also send Detail View interaction @ 
& Z ost relevant recommendations, Recombee by default identifies the user using first-party cookies stored on the 
muuBs Muues EBERHART FURNITURE 





Tilleegsplade Space Natura... Tilleegsplade Space Smoke... Hector Extra Leaves ` 


1,769.0 kr 1,769.0 kr 8,995.0 kr 






dow. recombeeIntegration| | function( ) { (recombeeIntegration.q=recom 


"rapifostname": ‘client-ray 
ns 


Optional: If you want to show a widget with the most popular items for users or bestsellers, 
choose Scenario Items to User. 
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The easiest demonstration of recommendation is the HTML widget with the most popular 
items which requires no coding. In Logic, choose Universal method-> recombee:default. 
There is no need for setting dynamic item ID. 


5 Display recommendations 

Once you are satisfied with the way the widget looks, you can instantly display it on your 
website by copying and pasting the generated HTML embed code into the source code of 
your website. 

















< detail-accessories 4 yk detail-accessories Embed Code x 
Default Grid Box Width Range 
(AB ih ok pea || We onaeeae To add this widget to your website, copy following code and past he exact location in the source code, where it should be displayed, 
> z i Once you put the embed code into your website, you can modify the widget in Admin UI without any need to change the code of your website. 
o Default Custom User ID S&S Segment ©@_ Also send Detail View interaction @ 
iZi To provide the most relevant recommendations, Recombee by default identifies the user using first-party cookies stored on the 

user's browser. 
You may need to notify your users about the use of Recombee Cookie depending on your user's country privacy laws. This is usually 
done by using a cookie manager deployed on your website. Please consult your legal team to determine whether this step is 
necessary. You can read more about the tracking cookie on our website 

MUUBS Muuss EBERHART FURNITURE 





Tillægsplade Space Natura...  Tillægsplade Space Smoke... Hector Extra Leaves” 


<seript>vindow.recombeeIntegration=vindow.recombeeintegration| | funetion( ) { (recombeeTntegration.q=recom 
1,769.0 kr 1,769.0 kr 8,995.0 kr <script> 


recombeeIntegration({ 


"type": * 
"itenr 








TET). 
*pubLicTol rusLic_zoxen @ 


"databaseld ample-organization-e-commerce-sample-db", 
"rapiHostname": "client-rapi.recombee.com: 443" 
He 
recombeeIntegration ({ 
"type": "AddDetailview" 
He 
recombeeIntegration ({ 
"type": "InitializeRecommendationWidget", 
"rootElementId": "widget-root-46d419c8-76a3-4904-8cf5-06c821c830ca", 
"widgetId": "46d419c8-76a3-4904-8cf5-06c821cB30ca" 
We 
</script> 
<script defer src="https: //web-integration. recombee.com/v1/recombee. js"></script> 
<div id="widget-root-46d419c8-76a3-4904-8c£5-06c821c830ca"></div> 





Copy to clipboard e 


6 Enjoy personalization by Al :) 


@ Recombee Demo Store Search... All categories v a | 39 Cart 


Home Categories v 


ES 





Just for you (Recombee) 


AANA 


&tradition &tradition &tradition &tradition Menu Menu 


In Between Chair - SK2 - Smok... In Between Chair - SK2 - Black ... In Between Chair - SK2 - Black ... In Between Chair - SK1 - Smok...  Afteroom Plywood Chair, Dark ... Harbour Side Chair, Dark Stain... 


4,495.0 kr 4,495.0 kr 3,495.0 kr 2,795.0 kr 4,795.0 kr 2,844.0 kr 
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Tip: Alternatively, you can also create a widget through the scenario section after creating 
your first scenario. This option can be found in the “Integration section” of the created 
scenario. Clicking “Create widget” will take you to the newly created widget, and you will be 


able to edit it to your preference. 


* Scenarios > Popular-Items items: > Preview Results 


Logic Filters (0) Boosters (0) Other 


ČI Request recommendations for this scenario using sample code below. Read the Getting Started guide for more information on integration 








© Js ® a £ php 9 ® 3S 
Widget JavaScript Python Ruby Java PHP C# NodeJS REST 
ees 


No Widgets for This Scenario 


Start by creating a new one or use any SDK for integration 


+ Create widget 
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Appendix 


1 Integration in Admin UI vs using API 


You can also integrate through API. This type of integration is aimed at developers for the 
management of interactions, items, and users in a script. You can integrate Recombee on 
your site using our SDK in the following languages: Java, Ruby, Node.js, PHP, Python, .NET. 
Client-side integration is built on JavaScript. 


API allows you to do the same tasks as in Admin UI and even more: 
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Add user-item interactions such as detail views, purchases, cart additions, and 
many others. 

Send the interactions to the recommender using the programming language of 
your choice. Historical interactions are preferred as they improve recommendation 
quality. 

You can add, remove, or update items in your item catalog. 

You can manage users in your database. 

Create custom business rules using a script or a more sophisticated approach. 
Batch uploads and edits. 


2 Add or edit properties for specific items 


For custom XML files which have sophisticated file structures there may be a need for 
tailored parsing of properties. 


1 Add item properties to compute recommendations 
This is beneficial for items that do not have many interactions. 


Click on “items” on the left side of the Admin UI and select “Manage properties” 


Insights 





INTEGRATION 


Q 





DVD-0564738 


CLO-29473856-1 











z 
B 
z 
EENE 


PEM654321 





o 
o 
CLO-29473856-2 © NULL NULL Adult 
o 
o 
o 


TV_123456 


Recombee 16 


Click “Create Property” 











:= Items. Items Properties x 
itemid additional_imagelink adult adwords redirect age_group availability availability date brand color Q Search Properties. 
STRING IMAGELIST BOOLEAN STRING STRING STRING TIMESTAMP STRING set 
VD-05647. o NU Ni N instock VULL BBC 0 additional_image_link IMAGE LIST 
-29473856-1 o N A Adult out of stock NULL M&S {"Navy"} 
adult BOOLEAN 
CLO-29473856-2 © N NU Adult in stock NULL M&S {"Navy"} 
adwords_redirect STRING 
CLO-1029384 o NULL NULL Adult in stock NULL Tenn Cool —_{ ‘White’, "Red", ' 
PFM654321 o NULL NULL NULL in stock VULL Dior {) age_group STRING 
TV_123456 o N Ni NULL in stock VULL LG D 
availability STRING 
availability_date TIMESTAMP 
brand STRING 
color SET 
condition STRING 





name it (e.g. title or category), choose a data type, and click “Create Property” again. 


= items 6 vem < New Property x 
itemid additional_image_link adult adwords_redirect age_group availability availability_date brand color Name 
STRING IMAGELIST BOOLEAN STRING STRING STRING TIMESTAMP STRING SET 


e.g. title, description, categories, image_url, 














DVD-0564738 ° N N NUI in stock VULL BBC 0 Data type 
CLO-294738561 © A NU Adult outofstock NULL Mas ("Navy") | BOOLEAN) DOUBLE) IMAGE) IMAGE_LIST) INT SET STRING | | TIMESTAMP 
CLO-29473856-2 © Ni A Adult in stock NULL Mas {"Navy"} 
CLO-1029384 o NULL NULL Adult in stock VULL Tenn Cool  {"White",' 
PFM654321 o NULL NULL NULL in stock NULL Dior p 
1234! o N NUI N in stock NULL Ls 0 





2 As the last step, after finishing creating properties, you will need to send item values 
Tip: Purchase is labeled as the following: replying to a job advertisement (job vertical), fully 


finishing watching a video (media vertical), or buying a product in an online store 
(ecommerce vertical). 
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